home *** CD-ROM | disk | FTP | other *** search
/ Power CD / Power CD ATARI-Rechner Lieben.iso / DEMOS / COLUMBUS / ERGODEMO / ERGODEMO.HLF < prev    next >
Encoding:
Text File  |  1994-01-17  |  33.7 KB  |  1,035 lines
  1. --------------------------------------------------
  2. - ERGO_PRO.HLP
  3. -
  4. - 9.1.94 CS
  5. - 9.1.94 GD
  6. - 14.1.94 cs
  7. -
  8. --------------------------------------------------
  9. -- Allgemeine Hilfen
  10. --------------------------------------------------
  11. #H Verschiedenes
  12. Das Drücken von <CONTROL> beim Starten eines Pro-
  13. gramms unterdrückt die Übergabe einer Kommandozei-
  14. le. Das gilt fast überall in der Shell.
  15.  
  16. Die Ausgabe der XRF-Datei kann auch an ein exter-
  17. nes Programm (Viewer) delegiert werden. Dieses
  18. Programm muß in 'Zugriffspfade' auf 'XRF' angemel-
  19. det werden.
  20.  
  21. Die Zwischendateien bei 'Extended Make' werden 
  22. im temporären Pfad abgelegt und auf Wunsch au-
  23. tomatisch wieder gelöscht. 
  24. Die im Projektfenster angezeigten XRF-,  XRB- 
  25. und PP-Dateien können ebenfalls im temp. Pfad
  26. abgelegt werden.  Die entsprechende Option ist
  27. in 'Einstellungen' zu setzen.
  28. -
  29. #H Allg. Hinweise
  30. Auch ein ACC (z.B. CHAMELEON) kann in 'Zugriffs-
  31. pfade' auf einen Extender angemeldet werden.
  32.  
  33. Zusätzliches Drücken von <SHIFT> beim Menüpunkt
  34. "PRJ sichern..." sichert die PRJ-Datei ohne vor-
  35. herige Dateiauswahlbox.
  36.  
  37. Die Menü-Shortcuts können mit einem geeigneten
  38. Resource-Editor geändert werden.
  39. --------------------------------------------------
  40. #H Dateien
  41. Einige Dateien spielen bei ERGO! eine besondere
  42. Rolle. Ihr Name richtet sich nach dem Namen der
  43. GFA-Datei. Wenn Ihre GFA-Datei "TEST.GFA" heißt,
  44. dann ist:
  45.  
  46. TEST~.GFA die Datei, die vom Präprozessor erzeugt
  47.           wird (hier wird also nur die Schlange  
  48.           an den Namen gehängt). Wir nennen sie
  49.           kurz 'PP-Datei'.
  50. TEST.XRB  die Datei mit den XRef-Informationen
  51.           (binäres Format, nicht lesbar),
  52. TEST.XRF  die Datei mit den lesbar ausgewerteten
  53.           XRef-Informationen
  54. --
  55. #H Dateien
  56. Für alle drei Typen existiert ein umrahmter Knopf
  57. im Projektfenster. Ist er grau, so existiert die
  58. Datei nicht. Ein Klick auf den grauen Knopf führt
  59. zur Erzeugung der Datei.
  60.  
  61. Die XRB-Datei wird vom Informer und Präprozessor
  62. automatisch angelegt, falls sie nicht vorhanden
  63. oder nicht mehr aktuell ist. 
  64.  
  65. Eine PP-Datei wird außer beim Präprozessor-Lauf 
  66. auch bei den folgenden Aktionen erzeugt:
  67.   - REMs löschen
  68.   - Informer
  69.   - Variablennamen ändern
  70. --------------------------------------------------
  71. #H Tastenbelegung
  72. <A>        Aufruf des ERGO!help-Accessorys
  73.  
  74. <UNDO>     aktualisiert den Inhalt des Projekt-
  75.            fensters.
  76.  
  77. <F1>-<F10> aktivieren ein Projekt, sofern es unter
  78.            'Projekt-Auswahl' eingetragen wurde.
  79.  
  80. <1>-<6>    aktivieren die Dateien im Projektfen-
  81.            ster (entsprechen einem Mausklick auf 
  82.            die Datei).
  83.  
  84. Die zur Bedienung des Ausgabe-Fensters zur Ver-
  85. fügung stehenden Tastenkombinationen entnehmen
  86. Sie bitte der Hilfe zu diesem Fenster.
  87.  
  88. #H Tastenbelegung
  89. Umschalttasten beim Starten von ERGO!pro und
  90. gleichzeitiger Übergabe einer GFA-Datei:
  91.           
  92. <keine>     Interpreter starten und GFA-Datei
  93.             laden.
  94.  
  95. <SHIFT>     'Start', Interpreter starten,
  96.             GFA-Datei laden und starten.
  97.  
  98. <CONTROL>   'Comp-Link', compilieren und linken.
  99.  
  100. <ALTERNATE> 'Anhalten', Interpreter nicht starten.
  101.  
  102. --------------------------------------------------
  103. #H Dialogboxen
  104. Die Dialoge von ERGO!pro sind 'fliegende Dialoge'.
  105. Sie unterscheiden sich von den herkömmlichen in 
  106. einigen Punkten.
  107.  
  108. Verschieben:
  109. Durch Anklicken der umgeklappten Ecke rechts oben 
  110. können sie verschoben werden. Wird dabei zusätz-
  111. lich <SHIFT> oder die rechte Maustaste gedrückt, 
  112. so wird der Dialog durchsichtig bewegt. 
  113.  
  114. Tastaturbedienung:
  115. Ein Objekt mit einem unterstrichenen Buchstaben 
  116. kann auch über die Tastatur bedient werden: 
  117. Drücken Sie hierzu die entsprechende Taste zusam-
  118. men mit <ALTERNATE>. 
  119. Alle Dialogboxen können auch mit der Taste <UNDO> 
  120. verlassen werden, was dem Anklicken von 'Abbruch' 
  121. entspricht.
  122. ----------
  123. #H Dialogboxen
  124. Hilfe allgemein:
  125. In fast allen Dialogen kann über die Taste <HELP>
  126. bzw. den gleichnamigen Knopf eine kleine Hilfe-
  127. stellung aufgerufen werden. 
  128.  
  129. Hilfe zu Texten:
  130. Das Anklicken eines Text-Objektes bei gedrückter 
  131. <SHIFT>-Taste liefert eine genauere Erklärung zu 
  132. diesem Objekt.
  133. --------------------------------------------------
  134. #H Projekt-Fenster
  135. Es enthält alle zum aktuellen Projekt gehörenden
  136. Dateien. Die Neubelegung der Felder erfolgt durch 
  137. Doppelklick mit der Maus.
  138.  
  139. Die obersten beiden liegen in der Bedeutung fest:
  140.   1. GFA-Datei
  141.   2. Programm-Datei (PRG,TTP,ACC...)
  142. Ein '*' vor der GFA-Datei zeigt an, daß sie jünger
  143. als das PRG ist und neu compiliert werden sollte.
  144.  
  145. Die unteren sechs Positionen können mit beliebigen
  146. Dateien belegt werden.
  147. --
  148. #H Projekt-Fenster
  149. Ein Einfachklick auf die Dateien aktviert sie:
  150.  
  151.  GFA-Datei -> Interpreter starten.
  152.  PRG-Datei -> starten
  153.  
  154. Bei allen anderen wird je nach Extension die zu-
  155. gehörige Anwendung gestartet (Interpreter, Text-
  156. editor, RCS, C-Compiler,...) und die Datei über-
  157. geben. Handelt es sich um ausführbare Dateien
  158. (sprich: Programme), so werden sie einfach ge-
  159. startet.
  160.  
  161. Die Einstellung der Anwendungen und die Zuordnung 
  162. der Extension muß zuvor im Dialog 'Zugriffspfade' 
  163. erfolgt sein.
  164. --
  165. #H Projekt-Fenster
  166. Die drei Felder am unteren Rand beziehen sich
  167. auf die festgelegten Dateien *.XRB, *.XRF und
  168. die PP-Datei.
  169.  'grau'    -> Datei existiert nicht
  170.  'schwarz' -> Datei existiert.
  171.  
  172. Klick auf grau      -> Datei erzeugen:
  173.  d.h. bei XRef      => XRef-Analyse starten
  174.           XRF-Datei => XRef-Ausgabe-Dialog
  175.                        aufrufen
  176.           PP-Datei  => Präprozessor-Dialog 
  177.                        aufrufen
  178.  
  179. Klick auf schwarz   -> Datei 'aktivieren':
  180.  d.h. bei XRef      => XRef-Analyse starten
  181.           XRF-Datei => Auswertung ins Fenster
  182.           PP-Datei  => Interpreter mit PP-Datei
  183.                        starten
  184. --------------------------------------------------
  185. #H Ausgabe-Fenster
  186. In dieses Fenster werden nahezu alle Ausgaben der
  187. Shell und des Compilers & Linkers getätigt. Auch
  188. die Anzeige der LOG-Datei erfolgt hier.
  189.  
  190. Das Fenster ist über die Tastatur bedienbar: 
  191. <Cursor>           -> Zeile hoch/runter scrollen
  192. <SHIFT-Cursor>     -> Seite hoch/runter blättern
  193. <CLR-HOME>         -> an den Anfang des Puffers
  194. <SHIFT CLR-HOME>   -> an das Ende
  195. <CONTROL CLR-HOME> -> Puffer löschen 
  196. --------------------------------------------------
  197. --## Hilfen zu Menüpunkten
  198. --------------------------------------------------
  199. #H Menü 'Datei'
  200. "Öffne GFA..."
  201.  Aktiviert eine neue GFA-Datei und lädt sie in das
  202.  Projektfenster. Wenn eine PRJ-Datei mit demselben
  203.  Namen existiert, wird das gesamte Projekt neu ge-
  204.  laden.
  205.  
  206. "Öffne PRJ..."
  207.  Aktiviert ein neues Projekt.
  208. #H Menü 'Datei'
  209. "Compilieren"
  210.  Compiliert die GFA-Datei und erzeugt dabei eine
  211.  Objekt-Datei GFABASIC.O im temporären Pfad.
  212.  
  213. "Linken"
  214.  Linkt die compilierte Objekt-Datei.
  215.  
  216. "Erstellen"
  217.  Compiliert und linkt die GFA-Datei.
  218.  
  219. #H Menü 'Datei'
  220. "Extended Make"
  221.  Bearbeitet die GFA-Datei zunächst mit dem Prä-
  222.  prozessor und compiliert dann sofort das Ergeb-
  223.  nis dieser Bearbeitung.
  224.  
  225.  Die Shell prüft das Datum der PP-Datei. Ist sie
  226.  jünger als die GFA-Datei (also frisch erzeugt),
  227.  so wird der PP-Lauf übersprungen und sofort 
  228.  compiliert. 
  229.  Will man aber den PP-Lauf erzwingen, so muß die
  230.  PP-Datei vorher gelöscht werden.
  231.  
  232. #H Menü 'Datei'
  233. "Testen"
  234.  Startet die zum GFA-Source gehörende Programm-
  235.  Datei.
  236.  
  237. "Infos"
  238.  Gibt einige Infos zur aktuellen GFA- und
  239.  Programmdatei aus. 
  240. #H Menü 'Datei'
  241. "PRJ sichern..."
  242.  Sichert alle zum aktiven Projekt gehörenden Ein-
  243.  stellungen in einer PRJ-Datei. Der Name dieser 
  244.  Datei ist wählbar und muß nicht mit dem Namen der
  245.  GFA-Datei übereinstimmen. So können zu einer ein-
  246.  zigen GFA-Datei mehrere Projekte festgelegt wer-
  247.  den. Wenn Sie diesen Menüpunkt mit gedrückter
  248.  <SHIFT>-Taste anwählen, wird die PRJ-Datei unter
  249.  den Namen der GFA-Datei abgespeichert und es er-
  250.  scheint keine Dateiauswahlbox.
  251.  
  252. "Beenden"
  253.  Beendet ERGO!pro ohne Sicherheitsabfrage.
  254.  
  255. --------------------------------------------------
  256. #H Menü 'Bearbeiten'
  257. "XRef-Analyse..."
  258.  Startet die Crossreferenzanalyse. Das Ergebnis 
  259.  wird in einer Datei *.XRB gespeichert. 
  260. --- Der XRB-Button 
  261.  
  262. "Präprozessor..."
  263.  Ruft den Präprozessor-Dialog auf. Der Präprozes-
  264.  sor bearbeitet die GFA-Datei auf drei verschie-
  265.  dene Arten:
  266.  
  267.  1. Symbolische Konstanten werden ersetzt
  268.  2. Programmteile werden ausgeblendet
  269.  3. 'Tote' Prozeduren werden ausgeblendet.
  270.  
  271.  Mehr dazu in der Hilfe zum Dialog.
  272.  
  273. --
  274. #H Menü 'Bearbeiten'
  275. "Informer..."
  276.  Fügt XRef-Informationen in den Quelltext ein. In
  277.  jedes Unterprogramm werden Information über die
  278.  verwendeten globalen Variablen, Felder und 
  279.  Aufrufe eingetragen. Ebenso können diese Angaben
  280.  wieder automatisch aus dem Listing entfernt 
  281.  werden.
  282.  
  283. "REMs löschen..."
  284.  Löscht alle Kommentare. Der Name der erzeugten
  285.  Datei erhält ein '~' am Ende (also wie die PP-
  286.  Datei).
  287. #H Menü 'Bearbeiten'
  288. "INLINEs..."
  289.  Erlaubt das Abspeichern und Laden der INLINE-
  290.  Bereiche eines Quelltextes.
  291.  
  292. "Variablen..."
  293.  Manipuliert die Variablentabelle des Quell-
  294.  textes.
  295.  
  296. "Dateien löschen"
  297.  Löscht die im Laufe einer Sitzung von ERGO ange-
  298.  legten Zwischendateien mit den Extendern '.XRB', 
  299.  '.XRF' und '~.GFA' sowie das LOG-File.
  300. --------------------------------------------------
  301. #H Menü 'Ausgabe'
  302. "XRef..."
  303.  Wertet die erstellte XRef-Analyse aus und gibt
  304.  das Ergebnis auf Drucker,  Bildschirm oder in 
  305.  eine Datei aus. Da in der Analyse eine Unmenge 
  306.  von Informationen gesammelt sind, kann im fol-
  307.  genden Dialog eine sehr präzise Auswahl getrof-
  308.  fen werden. 
  309.  
  310. "Statistik..."
  311.  Gibt eine kleine Statistik über das Programm 
  312.  und die Anzahl der verwendeten Bezeichner 
  313.  (Variablen, Labels,...) aus.
  314.  
  315. #H Menü 'Ausgabe'
  316. "Baumdiagramm..."
  317.  Gibt ein Baumdiagramm aller Unterprogramme aus
  318.  (Prozeduren und Funktionen).
  319.  
  320. "LOG-Datei"
  321.  Gibt die ERGO_TP.LOG-Datei - sofern vorhanden -
  322.  im Ausgabe-Fenster aus.
  323.  Hiermit können die Aktionen und Meldungen des 
  324.  Tokenprozessors nachvollzogen und kontrolliert
  325.  werden.
  326.  
  327. "Öffnen/Schließen"
  328.  Öffnet oder schließt das Ausgabe-Fenster.
  329.  
  330. --------------------------------------------------
  331. #H Menü 'Programme'
  332. Ermöglicht das Starten der Entwicklungs-Tools und
  333. weiterer beliebiger Programme. 
  334.  
  335. Außerdem kann hier eine bereits im Speicher 
  336. befindliche Kommandoshell (z.B. die MUPFEL) über 
  337. den "_shell_p"-Vektor aufgerufen werden.
  338. --------------------------------------------------
  339. #H Menü 'Parameter'
  340. "Compileroptionen..."
  341.  Konfiguriert die Compileroptionen.
  342.  Hilfen zur Bedeutung der einzelnen Optionen sind
  343.  im ERGO!help-Accessory enthalten und dort unter 
  344.  dem Stichwort 'Compileroptionen' zu finden.
  345.  
  346. "Linkeroptionen..."
  347.  Konfiguriert die Linkeroptionen.
  348.  (Mehr Hilfen dazu im Dialog selbst sowie im
  349.  ERGO!help-Accessory unter 'Linker')
  350.  
  351. ---
  352. #H Menü 'Parameter'
  353. "Zugriffspfade..."
  354.  Hier wird festgelegt, wo sich die von der Shell
  355.  aufrufbaren Programme befinden und auf welche 
  356.  Datei-Endungen sie angemeldet werden.
  357.  
  358. "Projekt-Auswahl..."
  359.  Ermöglicht die Belegung der F-Tasten mit belie-
  360.  bigen PRJ-Dateien bzw. deren Aktivierung. Der
  361.  Aufruf dieses Dialogs ist auch mit 'Mausklick
  362.  rechts' möglich!
  363. #H Menü 'Parameter'
  364. "Einstellungen..."
  365.  Ermöglicht die Konfiguration verschiedener 
  366.  Parameter der Shell.
  367.  
  368. "Parameter sichern"
  369.  Speichert die allgemeinen Einstellungen in der 
  370.  Datei "ERGO_PRO.INF".
  371. --------------------------------------------------
  372. -- Hilfen zu Dialogen
  373. --------------------------------------------------
  374. #H Präprozessor
  375. Der Präprozessor bearbeitet die GFA-Datei auf drei
  376. verschiedene Arten:
  377.  1. Symbolische Konstanten werden ersetzt
  378.  2. Programmteile werden mit Kommandos 
  379.     ausgeblendet.
  380.  3. 'Tote' Prozeduren werden ausgeblendet.
  381. Jede der drei Aktionen kann separat eingestellt
  382. werden.
  383. #H Präprozessor
  384. Die Reihenfolge der Aktionen ist genau so, wie 
  385. oben angegeben. D.h. es werden auch alle die
  386. 'toten' Prozeduren gelöscht, die erst durch das 
  387. Ausblenden im 2. Schritt 'getötet' wurden.
  388.  
  389. Die Präprozessor-Bearbeitung kann mit 'Start'
  390. sofort begonnen oder für 'Extended Make' konfi-
  391. guriert werden, dann ist der Dialog mit 'OK'
  392. zu verlassen.
  393.  
  394. Speicherung der Einstellungen erfolgt im PRJ-File.
  395.  
  396. --
  397. #O Symbolische Variablen ersetzen
  398. WORD- und BYTE-Variablen können als symbolische
  399. Konstanten betrachtet und im gesamten Quelltext
  400. durch ihren Wert ersetzt werden.
  401. Dazu müssen sie bei Ihrer Definition (Zuweisung)
  402. mit der Zeichenfolge '+SYM' markiert werden, z.B.
  403.  
  404.     ok_button&=1  !  +SYM
  405.  
  406. Zur blockweisen Definition von Symbolen ist der 
  407. Bereich mit ++SYM zu klammern, z.B.
  408.  
  409.     ' ++SYM
  410.     ok_button&=1  
  411.     abbruch_button&=2
  412.     ' ++SYM
  413. -
  414. #O Symbolische Variablen ersetzen
  415. Regeln: 
  416.  *  Zuweisung darf an beliebiger Stelle erfolgen.
  417.  *  In der Zuweisung sind keine Ausdrücke erlaubt.
  418.  *  +SYM steht am Ende der Zuweisungszeile, also 
  419.     in einem !-Kommentar.  Davor darf im Kommentar 
  420.     etwas stehen.
  421.  *  ++SYM in eigener Kommentarzeile.
  422.  *  Ein ++SYM-Block darf andere Anweisungen 
  423.     enthalten.
  424.  *  Symbolvariablen ausschließlich als globale 
  425.     Variablen einsetzen!!!
  426. --
  427. #O Programmteile entfernen
  428. Führt die "Präprozessor-Minus-Kommandos" mit den
  429. angegebenen Kennungen (max. 5) zur Ausblendung 
  430. von Programmteilen aus. 
  431.  
  432. Kommandos:
  433.   * Eine Zeile löschen:  -XYZ am Ende der Zeile.
  434.   * Eine PROC/FUNC löschen:  -XYZ am Ende der 
  435.     Kopfzeile (z.B.  PROCEDURE name(x,y)  !-XYZ)
  436.   * Ganzen Abschnitt löschen:  --XYZ davor und
  437.     dahinter angeben.
  438.  
  439. 'XYZ' steht für die frei wählbare Kennung, z.B.
  440. WEG, #PP, !PP, Dem, tst, ....
  441. #O Programmteile entfernen
  442. Regeln:
  443.  * Eine PP-Kennung muß genau 3 Zeichen umfassen.
  444.  * Groß-Kleinschreibung wird beachtet.
  445.  * --Befehle immer paarweise verwenden.
  446.  * --Befehle korrekt schachteln.
  447.  * PP-Anweisungen immer am Zeilenende, aber davor
  448.    darf etwas stehen.
  449. --
  450. #O Unbenutzte Prozeduren entfernen
  451. Entfernt alle Prozeduren und Funktionen aus dem 
  452. Quelltext, die nicht aufgerufen werden ('tote'). 
  453. Tote Prozeduren mit DATAs und DEFFNs werden 
  454. normalerweise nicht entfernt (geschützt). 
  455. Dieser Schutz kann unter 'Optionen' aufgehoben 
  456. werden.
  457. --
  458. #O DEFFNs und DATAs nicht schützen
  459. Normalerweise werden tote Prozeduren, die DEFFNs 
  460. oder DATAs enthalten, nicht entfernt (geschützt).
  461. Diese Vorgehensweise kann durch diese Option de-
  462. aktiviert werden. Allerdings werden so u.U. Pro-
  463. zeduren entfernt, die noch benötigt werden.
  464.  
  465. --------------------------------------------------
  466. #H Informer
  467. Der Informer fügt einige XRef-Informationen in den
  468. Quelltext ein. Die Eintragung kann wahlweise in 
  469. alle oder nur in die geöffneten Prozeduren erfol-
  470. gen. Der Eintrag erfolgt am Anfang der Prozeduren.
  471.  
  472. Die Informer-Zeilen werden mit einer speziellen 
  473. Kennung (.|) versehen, damit sie auch wieder auto-
  474. matisch aus dem Source gelöscht werden können.
  475. Hierzu dient der Modus 'Hinweise entfernen'.
  476.  
  477. Die Ausgabe erfolgt in die PP-Datei (~.GFA-Datei).
  478.  
  479. #O Hinweise einfügen in
  480. Schaltet auf Einfügemodus. Dabei kann ausgewählt
  481. werden, ob die Hinweise in alle oder nur in die
  482. aufgeklappten Prozeduren eingetragen werden sol-
  483. len. Auf diese Art kann man gezielt in einige
  484. wenige Prozeduren eintragen lassen.
  485.  
  486. Alte Eintragungen werden automatisch entfernt.
  487.  
  488. #O Hinweise entfernen
  489. Schaltet auf den Entfernungsmodus. So werden alle
  490. eingefügten Informationen wieder aus dem Quell-
  491. text beseitigt.
  492. --
  493. #O Globale Variablen
  494. Wenn Sie hier das Kreuz setzen, werden alle globa-
  495. len Variablen der betreffenden Prozedur eingetra-
  496. gen.
  497. --
  498. #O Felder
  499. Wenn Sie hier das Kreuz setzen, werden alle globa-
  500. len Felder der betreffenden Prozedur eingetragen.
  501.  
  502. Globale Felder im Sinne von ERGO! sind solche, die
  503. nicht innnerhalb dieser Prozedur dimensioniert und
  504. wieder gelöscht werden.
  505. --
  506. #O Aufrufe
  507. Wenn Sie hier das Kreuz setzen, werden Unterpro-
  508. gramm-Namen eingetragen, die in der betreffenden
  509. Prozedur aufgerufen werden.
  510. --
  511. #O Wird aufgerufen von
  512. Wenn Sie hier das Kreuz setzen, werden alle dieje-
  513. nigen Unterprogramme eingetragen, von welchen aus
  514. die aktuelle Prozedur aufgerufen wird.
  515. --------------------------------------------------
  516. #H INLINEs
  517. Sämtliche INLINE-Bereiche eines Quelltextes können
  518. über diese Funktion gespeichert und auch wieder
  519. geladen werden. Damit entfällt z.B. das mühselige
  520. Einlesen der INLINEs per Hand nach dem Speichern
  521. des Sources als ASCII-Datei.
  522.  
  523. Die INLINE-Bereiche können in einer Sammeldatei
  524. mit der Endung "IN~" oder in getrennten Files ab-
  525. gelegt werden. Im letzteren Fall werden die ersten
  526. acht Zeichen der INLINE-Variable als Dateinamen 
  527. verwendet (+Endung "INL"). (Vorsicht, Doppeldeu-
  528. tigkeiten möglich, wenn sich die Variablennamen
  529. erst nach dem achten Zeichen unterscheiden). 
  530.  
  531. Das Laden erfolgt in die Original-GFA-Datei!
  532.  
  533. #O INLINEs laden
  534. Lädt alle INLINE-Bereiche in die original
  535. GFA-Datei ein (nicht die PP-Datei).
  536. -
  537. #O INLINEs speichern
  538. Speichert alle INLINE-Bereiche.
  539. -
  540. #O einer Sammeldatei
  541. Die INLINEs werden in einer Sammeldatei abgelegt
  542. bzw. aus einer solchen geladen. Diese Einstellung
  543. ist sinnvoll, wenn die INLINEs zum Zwecke der Da-
  544. tensicherung ausgelagert werden bzw. der Quell-
  545. text im ASCII-Format gespeichert wurde und wieder
  546. eingeMERGEt werden soll.
  547.  
  548. Heißt Ihre Datei TEST.GFA, so wird die Sammeldatei
  549. TEST.IN~ genannt.
  550. -
  551. #O getrennten Dateien
  552. Die INLINEs werden in getrennten Dateien abgelegt
  553. und aus solchen geladen. Diese Einstellung ist
  554. sinnvoll, wenn die einzelnen INLINEs getrennt 
  555. weiterverarbeitet werden sollen.
  556. --------------------------------------------------
  557. #H Variablennamen manipulieren
  558. Verändert Variablennamen nach bestimmten Krite-
  559. rien. Sollte der neue Name bereits vergeben sein,
  560. so wird an den Namen solange ein 'x' angehängt,
  561. bis er ohne Doppeldeutigkeiten verwendet werden
  562. kann. Weitere Infos mit <SHIFT>-Mausklick auf
  563. das entsprechende Objekt.
  564.  
  565. Ausgabe in die ~.GFA-Datei.
  566. -
  567. #O Namen verschlüsseln
  568. Hierdurch werden alle Namen durch einen Buch-
  569. staben-Code ersetzt. So behandelte Quelltexte 
  570. sind garantiert unleserlich und damit vor unbe-
  571. fugten Einblicken geschützt.
  572.  
  573. Beispiel: breite&=rand&*2+@netto(inhalt#,modus&)
  574.       --> ae&=tk&*2+@el(pw#,nn&)
  575. #O Punkte entfernen
  576. Punkte werden aus den Namen eliminiert.
  577.  
  578. Beispiel: langer.name&
  579.       --> langername&
  580. #O Unterstriche entfernen
  581. Unterstriche werden aus den Namen eliminiert.
  582.  
  583. Beispiel: kauft_kekse_jetzt&
  584.       --> kauftkeksejetzt&
  585. #O Punkte zu Unterstrichen
  586. Punkte werden in Unterstriche umgewandelt.
  587.  
  588. Beispiel: pfad.ohne_sinn$
  589.       --> pfad_ohne_sinn$
  590. --------------------------------------------------
  591. #H XRef-Analyse
  592. Konfiguriert die Ausgabe der XRef-Analyse.
  593.  
  594. Hinweis:
  595. 'Fehlermeldungen als..' ist nur dann wählbar, 
  596. wenn 'Analyse: fehlerhafte Verwendungen' ein-
  597. gestellt ist. 
  598.  
  599. Speicherung der Einstellungen erfolgt im INF-File.
  600.  
  601. ---
  602. #O Hilfstexte
  603. Es werden einige Zeilen an Hilfstexten mit ausge-
  604. geben, die das Zurechtfinden in den Verweislisten
  605. erleichtern.                                     
  606. #O Unterprogramme auflisten
  607. Es werden die Namen aller Unterprogramme (PROC. +
  608. FUNC.) angegeben und zwar in der Reihenfolge, in
  609. welcher sie im Programm definiert sind. In dieser
  610. Reihenfolge sind sie auch numeriert. Diese Liste
  611. ist insbesondere dann wichtig, wenn die Verweise
  612. nicht über die Namen sondern über die Nummern der
  613. Prozeduren erfolgen.
  614. #O Variablentypen
  615. Hier können Sie die Ausgabe auf bestimmte Typen
  616. von Bezeichnern beschränken. 
  617.  
  618. #O Anfangsbuchstabe: 
  619. Unabhängig von allen anderen Auswahlmöglichkeiten
  620. kann die Ausgabe hiermit auf Namen mit einem be-
  621. stimmten Anfangsbuchstaben beschränkt werden.                                              
  622.  
  623. #O Verweise mit
  624. Jede der XRef-Informationen besteht aus 3 Teilen: 
  625.  1. Dem Namen (bzw. der Nummer) der Prozedur,      
  626.     in welcher die Variable auftritt               
  627.  2. Der Art des Auftretens (lokal, global,..)      
  628.  3. Der Angabe, wie oft die Variable dort 
  629.     erscheint.
  630. Hier steuern Sie die Darstellung des ersten Teils.
  631.  
  632. Mit 'Prozedurnummern' ist eine sehr kompakte Aus-
  633. gabe auch langer Listen möglich. Vorteil hierbei 
  634. ist die gute Übersicht, der Nachteil, daß man zu
  635. jeder Nummer den zugehörigen Prozedurnamen oben
  636. in der Liste nachsehen muß. Dies ist bei der Aus-
  637. gabe mit Namen nicht der Fall. Hierbei entstehen
  638. jedoch oft ellenlange Listen, die zum Ausdruck
  639. ungeeignet sind.
  640. -
  641. #O Fehlermeldungen als
  642. Die Fehlermeldungen können im Klartext oder durch
  643. die Fehlernummern ausgegeben werden. Bei Ausgabe
  644. als Nummern wird oben eine Liste der Fehlernummern
  645. mit der Bedeutung ausgegeben.
  646. --
  647. #O Analyse
  648. Hier wird eingestellt, nach welchen Kriterien die
  649. Verweis-Informationen zu den Namen auswertet und
  650. gefiltert werden.
  651. #O alle Variablen & Prozeduren
  652. Es wird garnicht gefiltert, sondern die kompletten
  653. Informationen zu allen Bezeichnern ausgegeben.
  654.  
  655. #O fehlerhafte Verwendungen
  656. Hier werden nur die Variablen herausgefiltert,
  657. die fehlerhaft verwendet werden, überflüssig sind
  658. o.ä. Die entsprechenden Situationen können von
  659. ERGO! anhand der Verweisinformationen entdeckt
  660. werden. Beispiele dazu im gedruckten Handbuch. 
  661. Die Fehlermeldungen und Warnungen können entweder
  662. als Nummern  oder als Texte ausgegeben werden
  663. (siehe Einstellung "Fehlermeldungen als..")
  664. Wenn 'Nummernausgabe' gewählt wurde, wird eine
  665. Liste der Fehlertexte vorangestellt.
  666. --
  667. #O partiell globale Variablen
  668. (oder auch "pseudolokale Variablen")
  669.  
  670. In GFA-Basic ist es gestattet, Variablen lokal zu
  671. definieren und in den tieferen Unterprogrammebenen
  672. als globale Variable zu verwenden. Diese sind dann
  673. in einem Teil des Unterprogramm-Baums global (d.h.
  674. 'partiell global'). In der PC-Version, in Basic
  675. 4.0 (und in den meisten anderen Sprachen) ist eine
  676. solche Verwendung nicht möglich.
  677.  
  678. Daher kann  es notwendig sein, diese Variablen aus
  679. dem Programm auszufiltern, was mit dieser Option
  680. ermöglicht wird.
  681. --
  682. #O globale Variablen
  683. Meistens sind es die globalen Variablen, welche
  684. die Übersicht erschweren und die hartnäckigsten
  685. Programmfehler erzeugen. Mit dieser Option kann
  686. man die Ausgabe auf diesen Typ von Variablen be-
  687. schränken.
  688. --
  689. #O mehrfach verwendete Namen
  690. Doppelt verwendete Namen (a& und a%) sind in GFA-
  691. Basic zwar erlaubt, sie können u.U. aber auch auf
  692. Tippfehler hindeuten. Mit dieser Option werden
  693. die mehrfach verwendeten Variablennamen gesucht.
  694.  
  695. -------------------------------------------------
  696. #H Baumdiagramm
  697. Mit dem Baumdiagramm wird die gesamte Unterproze-
  698. dur-Struktur auf einen Blick deutlich.  
  699. Die Darstellung ist in zwei Stufen wählbar, deren
  700. Unterschied jeweils in der angezeigten Verschach-
  701. telungstiefe liegt.      
  702.  
  703. Man sollte in der Regel die Darstellungsart 'opti-
  704. miert' verwenden, da eine 'vollständige' Ausgabe
  705. meistens sehr unübersichtlich wird und u.U. einen
  706. Überlauf des Ausgabebuffers erzeugt.
  707.  
  708. Speicherung der Einstellungen erfolgt im INF-File.
  709.  
  710. --
  711. #O vollständig:
  712. Hier wird der Prozedurbaum vollständig und in al- 
  713. len Ebenen angezeigt. Dies bedeutet, daß mehrfach 
  714. aufgerufene Unterprozeduren auch jedesmal mit dem 
  715. vollständigen Teilbaum dargestellt werden. Dadurch
  716. wird u.U. eine sehr aufgeblasene Darstellung mit 
  717. viel überflüssiger Information erzeugt. Außerdem 
  718. kann so bei stark verschachtelten Programmen der 
  719. Puffer überlaufen.
  720. --
  721. #O optimiert:
  722. Hier werden mehrfach auftretende Unterprogramme
  723. bei ihrem Aufruf mit einem Verweis auf ihre Nummer
  724. markiert und der zugehörige Teilbaum nur einmal
  725. gesondert ausgegeben.   Damit ist ein optimaler 
  726. Kompromiß zwischen Vollständigkeit und Übersicht-
  727. lichkeit gegeben.
  728. --
  729. #O Umbrechen
  730. Bei großen Strukturdiagrammen kann die Übersicht
  731. verbessert und eine Menge Papier gespart werden,
  732. wenn die Ausgabe in mehrere Spalten umbrochen er-
  733. folgt.   Wieviele Spalten sich ergeben hängt zum
  734. einen von der maximalen Breite des Diagramms und
  735. zum andernen von der gewählten Zeichendichte des
  736. Druckers ab.
  737. --------------------------------------------------
  738. #H Ausgabe: Baumdiagramm
  739. Hier geben Sie an, wohin die Ausgabe erfolgen 
  740. soll. Genauere Infos mit <SHIFT>-Mausklick auf
  741. das entsprechende Objekt.
  742.  
  743. Speicherung der Einstellungen erfolgt im PRJ-File.
  744.  
  745. -
  746. #H Ausgabe: XRef-Analyse
  747. Hier geben Sie an, wohin die Ausgabe erfolgen 
  748. soll. Genauere Infos mit <SHIFT>-Mausklick auf
  749. das entsprechende Objekt.
  750.  
  751. Speicherung der Einstellungen erfolgt im PRJ-File.
  752.  
  753. -
  754. #H Ausgabe: Statistik
  755. Gibt eine kleine Übersicht der Anzahl der verwen-
  756. deten Namenstypen (Variablen, Labels usw.) aus.
  757. Genauere Infos mit <SHIFT>-Mausklick auf das 
  758. entsprechende Objekt.
  759.  
  760. Speicherung der Einstellungen erfolgt im PRJ-File.
  761.  
  762. -
  763. #O Direkter Ausdruck
  764. Gibt die Auswertung der XRef auf dem Drucker aus.
  765. Das Layout wird in der PRN-Datei festgelegt.
  766.  
  767. #O Ausdruck in Datei umlenken
  768. Gibt die Auswertung der XRef in eine Druck-Datei
  769. aus. Diese Datei enthält dann auch die Steuer-
  770. zeichen für den Drucker.
  771.  
  772. Als Extender der Datei wird XRF genommen, genau
  773. wie für die Bildschirmdatei. Daher wird sie u.U.
  774. bei weiteren Ausgaben überschrieben. 
  775. Will man sie sichern, so sollte sie am besten 
  776. umbenannt werden.
  777. #O In eine XRF-Datei
  778. Gibt die Auswertung der XRef in eine Datei aus.
  779. Es handelt sich hierbei um eine reine ASCII-Datei
  780. ohne Steuerzeichen. 
  781. Diese kann dann mit einem Texteditor oder Viewer 
  782. betrachtet bzw. im Fenster der Shell ausgegeben 
  783. werden.
  784.  
  785. Die Formatierung erfolgt hierbei für die Standard-
  786. Bildschirmbreite von 80 Zeichen.
  787. #O In eine XRF-Datei, danach anzeigen
  788. Identisch mit dem vorigen Punkt, nur:
  789.  
  790. Die erzeugte Datei wird anschließend automatisch
  791. im Fenster der Shell angezeigt (bzw. an die auf 
  792. XRF angemeldete Anwendung übergeben).
  793. #O Druckertreiber:
  794. Sollen die Informationen auf einem Drucker oder in
  795. eine Druckdatei ausgegeben werde, so ist hier der
  796. passende Druckertreiber auszuwählen. Der Button 
  797. ist nur dann anwählbar, wenn 'Ausdruck..' einge-
  798. stellt ist.
  799.  
  800. Auswahl mit Doppelklick auf den Treibernamen. 
  801.  
  802. Die Treiberdateien haben alle die Endung PRN und
  803. liegen normalerweise im Unterordner \DRUCKER des
  804. ERGO-Pfades.
  805. #O Druckertreiber:
  806. Mit einem Einfachklick auf den Treibernamen kann
  807. die Ausgabe getestet werden, indem ein Beispiel-
  808. text auf dem Drucker ausgegeben wird. So kann
  809. überprüft werden, ob der Treiber seinen Zweck
  810. erfüllt.
  811. --------------------------------------------------
  812. #H Compileroptionen
  813. Die Compileroptionen können hier eingestellt wer- 
  814. den (alternativ können sie auch direkt im Quell-
  815. code gesetzt werden).
  816.  
  817. Direkt im Quellcode gesetzte Optionen haben immer
  818. Vorrang vor den hier eingestellten.
  819.  
  820. Hilfen zur Bedeutung der einzelnen Optionen sind
  821. im ERGO!help-Accessory enthalten und dort unter 
  822. dem Stichwort 'Compileroptionen' zu finden.
  823.  
  824. Speicherung der Einstellungen erfolgt im PRJ-File.
  825.  
  826. --
  827. -#O %3  Integerdivision immer
  828. -Integerdivisionen immer als Integerdivisionen
  829. -durchführen. Normalerweise ist das nur der Fall,
  830. -wenn der Compiler erkennt, daß das Ergebnis als
  831. -Integer verwendet wird.
  832. --
  833. -#O *&  Long-Multiplikation mit MULS
  834. -#O RC& 2-Byte RC_INTERSECT-Parameter
  835. -#O U+  Break und EVERY/AFTER testen
  836. -#O I+  Interrupt-Routinen aktiv
  837. -#O S&  2-Byte SELECT-Parameter
  838. -#O S>  SELECT Ausführungszeit optim.
  839. -#O E$  Fehlermeldungen als Text
  840. -#O B+  Bombenfehler als Nummern
  841. -#O P<  68000er Unterroutinen
  842. -#O F<  ENDFUNC wird nicht erzeugt
  843. -#O m$  Programm belegt
  844. --------------------------------------------------
  845. #H Linkeroptionen
  846. Es kann festgelegt werden,..
  847.  - welche Flags im Header der zu linkenden 
  848.    Programmdatei gesetzt werden sollen 
  849.  - welche Objektdateien dazugelinkt werden
  850.  - wie das erzeugte Programm heißen soll
  851.  
  852. Speicherung der Einstellungen erfolgt im PRJ-File.
  853.  
  854. #O Fastload
  855. Das Setzen dieses Flags beschleunigt das Laden
  856. des Programms. Es veranlaßt das Betriebssystem,
  857. beim Programmstart nicht den gesamten Systemspei-
  858. cher zu löschen, sondern nur das BSS-Segment.
  859. Daher sollte man sich nie darauf verlassen, daß
  860. mit MALLOC angeforderte Speicherbereiche leer
  861. sind.
  862. Kann normalerweise gesetzt werden.
  863. #O Ins TT-RAM laden
  864. Bewirkt, daß das Programm auf einem TT in das
  865. schnelle "Fast-RAM" geladen wird. Programme, die
  866. in dieser Speicherart laufen sollen, dürfen
  867.  -keinen DMA-Sound benutzen
  868.  -nicht mit XBIOS(5) einen 2. Bildschirm verwalten
  869.  -nicht direkt auf ACSI-Festplatten zugreifen
  870.  
  871. #O MALLOCs aus TT-RAM
  872. Erlaubt es dem Programm, mittels MALLOC auch
  873. Speicherbereiche aus dem Fast-RAM anzufordern.
  874.  
  875. Kann normalerweise gesetzt werden.
  876. #O MTOS-Speicherschutz:
  877. Dieses Flag ist nur unter MultiTOS von Interesse,
  878. die Voreinstellung ist hier "Private". 
  879. #O Symboltabelle anhängen
  880. Hiermit erzeugt der Linker im Programm eine Sym-
  881. boltabelle, mit welcher das übersetzte Programm 
  882. disassembliert und nach Symbolen debuggt werden
  883. kann.                
  884. #O Objekt-Dateien hinzulinken:
  885. Wenn zu der Objektdatei des Projekt-Files noch
  886. weitere dazugebunden werden sollen, so können
  887. diese hier eingetragen werden (maximal sechs).
  888.  
  889. Eintragung mit Doppelklick auf die Felder.
  890.  
  891. Damit die Dateien dazugelinkt werden, muß natür-
  892. lich das Kreuz gesetzt sein.
  893. #O Erzeugtes Programm:
  894. Der Dateiname des zu erzeugenden Programms kann 
  895. durch Anklicken mit Doppelklick festgelegt werden.
  896. Über das Popup kann schnell zwischen verschiedenen
  897. Extendern gewechselt werden.
  898.  
  899. Der Programmname wird im Projektfenster angezeigt
  900. und kann auch dort geändert werden.
  901. --------------------------------------------------
  902. #H GFA-BASIC Sets
  903. Es können bis zu 6 verschiedene Sets festgelegt
  904. werden, die jeweils aus den Pfaden des Interpre-
  905. ters, Compilers, Linkers und Library bestehen.
  906. Jedes Set kann mit einem beliebigen Namen ver-
  907. sehen werden. Über das Popup im Projekt-Fenster
  908. kann das Set bestimmt werden, welches für das 
  909. aktuelle Projekt gilt und im PRJ-File vermerkt 
  910. wird.
  911.  
  912. Unterschiedliche Sets sind z.B. sinnvoll, wenn
  913. eine Komponente des Basic-Entwicklungssystems
  914. gepatcht wurde, aber nicht bei jedem Projekt
  915. benutzt werden soll.
  916. #H GFA-BASIC Sets
  917. Hinweis:
  918. Die Sets werden in der INF-Datei gesichert. Die 
  919. PRJ-Datei enthält nur die Nummer des Sets, welches
  920. für das Projekt gewählt wurde. 
  921. Ändern Sie also die Reihenfolge der Sets, so müs-
  922. sen auch die Nummern in den Projekten angepaßt 
  923. werden.
  924. --------------------------------------------------
  925. #H Zugriffspfade
  926. Hier werden die Zugriffspfade der einzelnen Pro-
  927. gramme festgelegt. Diese Programme können auch 
  928. auf bestimmte Dateiendungen 'angemeldet' werden:
  929. Dazu ist einfach eine durch Kommata getrennte
  930. Liste der gewünschten Extender anzugeben. 
  931. Der Extender '*' bezeichnet eine Default-Applika-
  932. tion, die aufgerufen wird, wenn zuvor kein passen-
  933. der Extender gefunden wurde  (z.B. ein Texteditor
  934. oder Viewer).
  935. #H Zugriffspfade
  936. Neben den eigentlichen Entwicklungs-Tools können 
  937. auch bis zu sieben beliebige Programme eingetragen
  938. werden. 
  939.  
  940. Die ersten vier davon werden im ERGO_PRO.INF-File
  941. gespeichert, sind also in jedem Projekt verfügbar.
  942.  
  943. Die letzten drei werden nur im jeweiligen PRJ-File
  944. gespeichert. 
  945.  
  946. Die Menüeinträge für diese Programme können frei 
  947. gewählt werden (z.B: "Disassembler", "Editor").
  948.  
  949. #H Zugriffspfade
  950. Der temporäre Pfad wird von der Shell häufig benö-
  951. tigt und sollte sich nach Möglichkeit auf einer 
  952. Ramdisk befinden. Hier werden z.B. das Objektfile
  953. und (falls in "Einstellungen..." so festgelegt)
  954. auch XRB-, XRF und ~.GFA-Dateien abgelegt.  Der 
  955. temporäre Pfad wird in der INF-Datei gespeichert.
  956.  
  957. --------------------------------------------------
  958. #H Projekt-Auswahl
  959. Auf die Funktionstasten können beliebige PRJ-Da-
  960. teien gelegt werden. Somit kann mit einem Tasten-
  961. druck schnell zwischen verschiedenen Projekten
  962. gewechselt werden. 
  963.  
  964. Doppelklick  -> Neubelegung der F-Taste
  965. Einfachklick -> Aktiviert das Projekt
  966. F-Taste      ->     "      "     "
  967.  
  968. Speicherung der Einstellungen erfolgt im INF-File.
  969.  
  970. --------------------------------------------------
  971. #H Einstellungen
  972. Ermöglicht die Konfiguration verschiedener Parame-
  973. ter des ERGO!pro-Entwicklungssystems. Genauere
  974. Infos nach <SHIFT>-Mausklick auf das entsprechende
  975. Objekt.
  976.  
  977. Speicherung der Einstellungen erfolgt im INF-File.
  978.  
  979. --
  980. #O Nach Compiler-Warnungen nicht mehr linken
  981. Bricht den 'Make'-Vorgang nach einem Fehler beim 
  982. Compilieren ab und linkt nicht mehr.
  983. Will man trotz Fehler weitermachen, so ruft man 
  984. einfach anschließend den Linker auf.
  985. --
  986. #O Projekt-Informationen nach dem Compilieren anzeigen
  987. Gibt nach dem Compilieren eine kurze Information 
  988. zum GFA-, PRG- und altem PRG-File aus.  
  989. Damit kann man z.B. direkt sehen, wieviel größer 
  990. das PRG-File geworden ist.
  991. --
  992. #O Objektdatei nach dem Linken löschen
  993. Löscht die vom Compiler erzeugte Objektdatei
  994. GFABASIC.O automatisch nach dem Compilieren.
  995.  
  996. --
  997. #O Zwischendateien nach 'Extended Make' löschen
  998. Löscht die von ERGO! während des 'Extended Make'
  999. erzeugten .XRB und ~.GFA-Dateien automatisch
  1000. nach der erfolgreichen Compilierung.
  1001. --
  1002. #O XRB, XRF und ~.GFA Dateien im temp. Pfad ablegen
  1003. Legt alle von ERGO im Laufe einer Sitzung angeleg-
  1004. ten Dateien (XRB, XRF, ~.GFA usw.) im temporären
  1005. Pfad und nicht im Verzeichnis des Projektes ab.
  1006. Somit sammeln sich im Laufe der Zeit keine über-
  1007. flüssigen Dateien auf dem Laufwerk an.
  1008. --
  1009. #O LOG-Datei anlegen
  1010. Veranlaßt den ERGO!-Tokenprozessor dazu, alle
  1011. Aktionen und Fehlermeldungen in einer LOG-Datei
  1012. zu protokollieren. Diese Datei wird unter dem Na-
  1013. men ERGO_TP.LOG im Verzeichnis \ERGO_TMP angelegt
  1014. und kann jederzeit mit dem Menüpunkt  'LOG-Datei'
  1015. (Menü 'Ausgabe') angezeigt werden.
  1016. --
  1017. #O Ausgabepuffer während eines Programmlaufs auslagern
  1018. Gibt den Speicher des Ausgabepuffers vor einem 
  1019. Programmstart frei und lagert ihn auf den tempo-
  1020. rären Pfad aus. Das ist eigentlich nur dann nötig,
  1021. wenn das zu startende Programm sehr viel Speicher
  1022. benötigt.
  1023. --
  1024. #O Ausgabe-Dialog unterdrücken
  1025. Normalerweise erscheint bei der Ausgabe von XRef,
  1026. Statistik und Baumdiagramm nach dem jeweiligen
  1027. Einstellungs- noch der Ausgabe-Dialog, in dem z.B.
  1028. das Zielgerät der Ausgabe festgelegt werden kann.
  1029. Diese Option unterdrückt den Dialog und verwendet
  1030. die zuletzt darin gemachten Ausgabe-Einstellungen.
  1031.  
  1032. #
  1033. ##
  1034.  
  1035.